Node / meshtastic / Meshtastic-Android / files / core / ui / src / commonMain / kotlin / org / meshtastic / core / ui / component / FirmwareVersionCheck.kt

Displaying Raw • Download

T8b949e/*

* Copyright (c) 2026 Meshtastic LLC

*

* This program is free software: you can redistribute it and/or modify

* it under the terms of the GNU General Public License as published by

* the Free Software Foundation, either version 3 of the License, or

* (at your option) any later version.

*

* This program is distributed in the hope that it will be useful,

* but WITHOUT ANY WARRANTY; without even the implied warranty of

* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

* GNU General Public License for more details.

*

* You should have received a copy of the GNU General Public License

* along with this program. If not, see <https://www.gnu.org/licenses/>.

*/

Tff7b72package T7ee787org.meshtastic.core.ui.component

Tff7b72import T7ee787androidx.compose.runtime.Composable

Tff7b72import T7ee787androidx.compose.runtime.LaunchedEffect

Tff7b72import T7ee787androidx.compose.runtime.getValue

Tff7b72import T7ee787androidx.lifecycle.compose.collectAsStateWithLifecycle

Tff7b72import T7ee787co.touchlab.kermit.Logger

Tff7b72import T7ee787org.jetbrains.compose.resources.getString

Tff7b72import T7ee787org.meshtastic.core.model.ConnectionState

Tff7b72import T7ee787org.meshtastic.core.model.DeviceVersion

Tff7b72import T7ee787org.meshtastic.core.model.FirmwareCheckStatus

Tff7b72import T7ee787org.meshtastic.core.resources.Res

Tff7b72import T7ee787org.meshtastic.core.resources.firmware_old

Tff7b72import T7ee787org.meshtastic.core.resources.firmware_too_old

Tff7b72import T7ee787org.meshtastic.core.resources.should_update

Tff7b72import T7ee787org.meshtastic.core.resources.should_update_firmware

Tff7b72import T7ee787org.meshtastic.core.ui.viewmodel.UIViewModel

T8b949e/**

* Common component to check the connected device's firmware version against the minimum required version. Will display

* a dismissable alert if the firmware is old, or a blocking alert if it is too old.

*/

Tf0883e@Composable

Tff7b72fun Td2a8ffFirmwareVersionCheckTb4b4b4(Te6edf3viewModelTb4b4b4: Te6edf3UIViewModelTb4b4b4) Tb4b4b4{

Tff7b72val Te6edf3connectionState Tff7b72by Te6edf3viewModelTb4b4b4.Te6edf3connectionStateTb4b4b4.Te6edf3collectAsStateWithLifecycleTb4b4b4(Tb4b4b4)

Tff7b72val Te6edf3myNodeInfo Tff7b72by Te6edf3viewModelTb4b4b4.Te6edf3myNodeInfoTb4b4b4.Te6edf3collectAsStateWithLifecycleTb4b4b4(Tb4b4b4)

Tff7b72val Te6edf3myFirmwareVersion Tff7b72= Te6edf3myNodeInfoTff7b72?.Te6edf3firmwareVersion

Tff7b72val Te6edf3firmwareEdition Tff7b72by Te6edf3viewModelTb4b4b4.Te6edf3firmwareEditionTb4b4b4.Te6edf3collectAsStateWithLifecycleTb4b4b4(Tff7b72nullTb4b4b4)

Tff7b72val Te6edf3latestStableFirmwareRelease Tff7b72by

Te6edf3viewModelTb4b4b4.Te6edf3latestStableFirmwareReleaseTb4b4b4.Te6edf3collectAsStateWithLifecycleTb4b4b4(Te6edf3DeviceVersionTb4b4b4(Ta5d6ff"Ta5d6ff2.6.4Ta5d6ff"Tb4b4b4)Tb4b4b4)

Te6edf3LaunchedEffectTb4b4b4(Te6edf3connectionStateTb4b4b4, Te6edf3firmwareEditionTb4b4b4) Tb4b4b4{

Tff7b72if Tb4b4b4(Te6edf3connectionState Tff7b72=Tff7b72= Te6edf3ConnectionStateTb4b4b4.Te6edf3ConnectedTb4b4b4) Tb4b4b4{

Te6edf3firmwareEditionTff7b72?.Te6edf3let Tb4b4b4{ Te6edf3edition Tff7b72-Tff7b72> Te6edf3LoggerTb4b4b4.Te6edf3d Tb4b4b4{ Ta5d6ff"Ta5d6ffFirmwareEdition: Tffd700${Te6edf3editionTb4b4b4.Te6edf3nameTffd700}Ta5d6ff" Tb4b4b4} Tb4b4b4}

Tb4b4b4}

Tb4b4b4}

Te6edf3LaunchedEffectTb4b4b4(Te6edf3connectionStateTb4b4b4, Te6edf3myNodeInfoTb4b4b4) Tb4b4b4{

Tff7b72if Tb4b4b4(Te6edf3connectionState Tff7b72=Tff7b72= Te6edf3ConnectionStateTb4b4b4.Te6edf3ConnectedTb4b4b4) Tb4b4b4{

Te6edf3myNodeInfoTff7b72?.Te6edf3let Tb4b4b4{ Te6edf3info Tff7b72-Tff7b72>

Te6edf3myFirmwareVersionTff7b72?.Te6edf3let Tb4b4b4{ Te6edf3fwVersion Tff7b72-Tff7b72>

Tff7b72val Te6edf3curVer Tff7b72= Te6edf3DeviceVersionTb4b4b4(Te6edf3fwVersionTb4b4b4)

Te6edf3LoggerTb4b4b4.Te6edf3i Tb4b4b4{

Ta5d6ff"Ta5d6ff[FW_CHECK] Firmware version comparison - Ta5d6ff" Tff7b72+

Ta5d6ff"Ta5d6ffdevice: Tffd700$Te6edf3curVerTa5d6ff (raw: Tffd700$Te6edf3fwVersionTa5d6ff), status: Tffd700${Te6edf3curVerTb4b4b4.Te6edf3checkStatusTffd700}Ta5d6ff, Ta5d6ff" Tff7b72+

Ta5d6ff"Ta5d6ffabsoluteMin: Tffd700${Te6edf3DeviceVersionTb4b4b4(Te6edf3DeviceVersionTb4b4b4.Te6edf3ABS_MIN_FW_VERSIONTb4b4b4)Tffd700}Ta5d6ff, Ta5d6ff" Tff7b72+

Ta5d6ff"Ta5d6ffmin: Tffd700${Te6edf3DeviceVersionTb4b4b4(Te6edf3DeviceVersionTb4b4b4.Te6edf3MIN_FW_VERSIONTb4b4b4)Tffd700}Ta5d6ff"

Tb4b4b4}

Tff7b72when Tb4b4b4(Te6edf3curVerTb4b4b4.Te6edf3checkStatusTb4b4b4) Tb4b4b4{

Te6edf3FirmwareCheckStatusTb4b4b4.Te6edf3TOO_OLD Tff7b72-Tff7b72> Tb4b4b4{

Te6edf3LoggerTb4b4b4.Te6edf3w Tb4b4b4{

Ta5d6ff"Ta5d6ff[FW_CHECK] Firmware too old - device: Tffd700$Te6edf3curVerTa5d6ff < Ta5d6ff" Tff7b72+

Ta5d6ff"Ta5d6ffabsoluteMin: Tffd700${Te6edf3DeviceVersionTb4b4b4(Te6edf3DeviceVersionTb4b4b4.Te6edf3ABS_MIN_FW_VERSIONTb4b4b4)Tffd700}Ta5d6ff"

Tb4b4b4}

Tff7b72val Te6edf3title Tff7b72= Te6edf3getStringTb4b4b4(Te6edf3ResTb4b4b4.Te6edf3stringTb4b4b4.Te6edf3firmware_too_oldTb4b4b4)

Tff7b72val Te6edf3message Tff7b72= Te6edf3getStringTb4b4b4(Te6edf3ResTb4b4b4.Te6edf3stringTb4b4b4.Te6edf3firmware_oldTb4b4b4)

Te6edf3viewModelTb4b4b4.Te6edf3showAlertTb4b4b4(

Te6edf3title Tff7b72= Te6edf3titleTb4b4b4,

Te6edf3html Tff7b72= Te6edf3messageTb4b4b4,

Te6edf3onConfirm Tff7b72= Tb4b4b4{ Te6edf3viewModelTb4b4b4.Te6edf3setDeviceAddressTb4b4b4(Ta5d6ff"Ta5d6ffnTa5d6ff"Tb4b4b4) Tb4b4b4}Tb4b4b4,

Tb4b4b4)

Tb4b4b4}

Te6edf3FirmwareCheckStatusTb4b4b4.Te6edf3SHOULD_UPDATE Tff7b72-Tff7b72> Tb4b4b4{

Te6edf3LoggerTb4b4b4.Te6edf3w Tb4b4b4{

Ta5d6ff"Ta5d6ff[FW_CHECK] Firmware should update - Ta5d6ff" Tff7b72+

Ta5d6ff"Ta5d6ffdevice: Tffd700$Te6edf3curVerTa5d6ff < min: Tffd700${Te6edf3DeviceVersionTb4b4b4(Te6edf3DeviceVersionTb4b4b4.Te6edf3MIN_FW_VERSIONTb4b4b4)Tffd700}Ta5d6ff"

Tb4b4b4}

Tff7b72val Te6edf3title Tff7b72= Te6edf3getStringTb4b4b4(Te6edf3ResTb4b4b4.Te6edf3stringTb4b4b4.Te6edf3should_update_firmwareTb4b4b4)

Tff7b72val Te6edf3message Tff7b72= Te6edf3getStringTb4b4b4(Te6edf3ResTb4b4b4.Te6edf3stringTb4b4b4.Te6edf3should_updateTb4b4b4, Te6edf3latestStableFirmwareReleaseTb4b4b4.Te6edf3asStringTb4b4b4)

Te6edf3viewModelTb4b4b4.Te6edf3showAlertTb4b4b4(Te6edf3title Tff7b72= Te6edf3titleTb4b4b4, Te6edf3message Tff7b72= Te6edf3messageTb4b4b4, Te6edf3onConfirm Tff7b72= Tb4b4b4{Tb4b4b4}Tb4b4b4)

Tb4b4b4}

T8b949e// An unparseable/transient version must not disconnect the device (#3726); just log it.

Te6edf3FirmwareCheckStatusTb4b4b4.Te6edf3UNKNOWN Tff7b72-Tff7b72>

Te6edf3LoggerTb4b4b4.Te6edf3w Tb4b4b4{ Ta5d6ff"Ta5d6ff[FW_CHECK] Firmware version unparseable - device raw: Tffd700$Te6edf3fwVersionTa5d6ff, skippingTa5d6ff" Tb4b4b4}

Te6edf3FirmwareCheckStatusTb4b4b4.Te6edf3OK Tff7b72-Tff7b72>

Te6edf3LoggerTb4b4b4.Te6edf3i Tb4b4b4{ Ta5d6ff"Ta5d6ff[FW_CHECK] Firmware version OK - device: Tffd700$Te6edf3curVerTa5d6ff meets requirementsTa5d6ff" Tb4b4b4}

Tb4b4b4}

Tb4b4b4}

Tb4b4b4}

Tb4b4b4}

Tb4b4b4}

Tb4b4b4}